home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / bbs / rp100.zip / RELEASE.NOT < prev    next >
Text File  |  1993-12-26  |  52KB  |  1,503 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.           The Prime External Request Processor v1.00
  34.  
  35.  
  36.           By Hans Siemons, Prime Productions.
  37.  
  38.           Setup utility by Marco Miltenburg.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                         Prime request processor documentation
  47.  
  48.           Table of contence:
  49.  
  50.  
  51.           1 Introduction  . . . . . . . . . . . . . . . . . . . . . . .     1
  52.             Small overview of features  . . . . . . . . . . . . . . . .     1
  53.             Files included  . . . . . . . . . . . . . . . . . . . . . .     2
  54.  
  55.           2 Installation  . . . . . . . . . . . . . . . . . . . . . . .     4
  56.             Setting up  . . . . . . . . . . . . . . . . . . . . . . . .     4
  57.             System parameters . . . . . . . . . . . . . . . . . . . . .     5
  58.             Default limits  . . . . . . . . . . . . . . . . . . . . . .     7
  59.             Group manager . . . . . . . . . . . . . . . . . . . . . . .     7
  60.             Node manager  . . . . . . . . . . . . . . . . . . . . . . .     9
  61.             Level Manager . . . . . . . . . . . . . . . . . . . . . . .     9
  62.             About . . . . . . . . . . . . . . . . . . . . . . . . . . .    10
  63.  
  64.           3 Template files  . . . . . . . . . . . . . . . . . . . . . .    11
  65.             Keywords  . . . . . . . . . . . . . . . . . . . . . . . . .    14
  66.             Template filenames  . . . . . . . . . . . . . . . . . . . .    15
  67.             Language specific templates . . . . . . . . . . . . . . . .    15
  68.  
  69.           4 Compilers . . . . . . . . . . . . . . . . . . . . . . . . .    16
  70.             RPcomp  . . . . . . . . . . . . . . . . . . . . . . . . . .    16
  71.             RPnl  . . . . . . . . . . . . . . . . . . . . . . . . . . .    16
  72.             FBBSDESC  . . . . . . . . . . . . . . . . . . . . . . . . .    17
  73.             RAdesc  . . . . . . . . . . . . . . . . . . . . . . . . . .    17
  74.             MAXdesc . . . . . . . . . . . . . . . . . . . . . . . . . .    17
  75.             Other compilers . . . . . . . . . . . . . . . . . . . . . .    17
  76.  
  77.           5 RPpack  . . . . . . . . . . . . . . . . . . . . . . . . . .    18
  78.  
  79.           6 RP at work  . . . . . . . . . . . . . . . . . . . . . . . .    19
  80.  
  81.           7 Support . . . . . . . . . . . . . . . . . . . . . . . . . .    20
  82.             Thanks  . . . . . . . . . . . . . . . . . . . . . . . . . .    20
  83.  
  84.           8 Shareware . . . . . . . . . . . . . . . . . . . . . . . . .    21
  85.             Legal stuff / standard disclaimer . . . . . . . . . . . . .    21
  86.  
  87.           9 Future versions . . . . . . . . . . . . . . . . . . . . . .    22
  88.  
  89.           10 Technical notes  . . . . . . . . . . . . . . . . . . . . .    23
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.           Page I
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.                                         Prime request processor documentation
  108.  
  109.           ╔════════════════════════════════════════════════════════════════╕
  110.           ║≡ 1 Introduction ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  111.           ╙────────────────────────────────────────────────────────────────┘
  112.  
  113.           Welcome to the Prime external request processor (from here on
  114.           called RP). This program is the one you need if you find
  115.           Frontdoors capabilities of handling requests not sufficient.
  116.           RP takes over the handling of filerequests, and offers more
  117.           request limiting capabilities then Frontdoor does.
  118.  
  119.           RP needs DOS 3.30 or higher and a properly installed Frontdoor
  120.           2.11 (registered version only) or a Frontdoor 2.20a.Ml or higher
  121.           package (with the FD environment variable set)
  122.  
  123.           ╔════════════════════════════════════════════════════════════════╕
  124.           ║≡ Small overview of features ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  125.           ╙────────────────────────────────────────────────────────────────┘
  126.  
  127.           Following is a list of features found in RP: (features marked with
  128.           {+} are only available in the registered version)
  129.  
  130.            ■ Request limits per timeslot {+} and per sessionsion. ie, max 5
  131.              files in one session, and 10 files in a day.
  132.            ■ Request limits depending the requesting system, time, baudrate,
  133.              day of the week.
  134.            ■ Variate the list of requestable files depending the requesting
  135.              system, time, baudrate, day of the week, secure/unsure sessions
  136.              and for unlisted nodes!
  137.            ■ Password protected files only for specific nodes, or during
  138.              certain time slots.
  139.            ■ Easy "about" requesting.
  140.            ■ Attach messages if people request certain files, or from
  141.              certain directory's.
  142.            ■ Very powerful template language. Templates can be chosen
  143.              depending the node number of the requesting system.
  144.            ■ Send file descriptions in response message.
  145.  
  146.           For instance, you can setup your points and personal friends so
  147.           that they can request without limitations, let people request your
  148.           magic names around the clock, but refusing the other files to be
  149.           requested on "busy" hours. You can send a message if somebody
  150.           requests RP, congratulating them on their excellent choice.
  151.           The number of ways to use it are endless.
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.           Page 1
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.                                         Prime request processor documentation
  169.  
  170.           ╔════════════════════════════════════════════════════════════════╕
  171.           ║≡ Files included ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  172.           ╙────────────────────────────────────────────────────────────────┘
  173.  
  174.           The following files are in the RP100.ARJ archive (may also be any
  175.           other archive format):
  176.  
  177.           RPCOMP.EXE   Filebase compiler. Compiles the filebase, so that the
  178.                        request processor can search files much faster. Speed
  179.                        is important, because searching for files is done
  180.                        while a session is going on.
  181.           RP.EXE       The request processor itselve.
  182.           RPSETUP.EXE  The setup utility
  183.           RPPACK.EXE   Small utility to pack REQUESTD.RP. When packing it
  184.                        keep the last 500 records.
  185.           INSTALL.EXE  A small installation program. Puts the RP commandline
  186.                        in Setup.FD, and turns on usage of the request
  187.                        processor.
  188.           RPNL.EXE     RP nodelist compiler.
  189.           RP.DOC       This documentation.
  190.           SUPPORT.DOC  List of worldwide support and registration sites.
  191.           PRIMEREG.EXE Registration form program. This program "takes your
  192.                        orders", and fills in the registration form for you.
  193.           FILE_ID.DIZ  Small description of RP.
  194.           RPSTRUCT.INC Structure file of RP.
  195.           SAMPLE.ARJ   Sample template files, sample REQUESTD.RP and
  196.                        TPLEXT.RP.
  197.           FREEREG.!!!  How to earn a free RP registration!
  198.           FBBSDESC.EXE Description compiler for Files.BBS systems
  199.           RADESC.EXE   Description compiler for Remote Access v2.xx systems.
  200.           RAPWDLST.EXE Creates a list of password protected files from the
  201.                        RA 2.00 file database.
  202.           TBAV.NOT     Note about the Thunderbyte anti virus utilities.
  203.           PASCAL.ARJ   Units to help build a description compiler plus the
  204.                        source code of RAPWDLST.EXE. Compiled units are TP
  205.                        7.0 real mode format.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.           Page 2
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.                                         Prime request processor documentation
  230.  
  231.           ╔════════════════════════════════════════════════════════════════╕
  232.           ║≡ Files created ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  233.           ╙────────────────────────────────────────────────────────────────┘
  234.  
  235.           RP itselve creates the following files:
  236.  
  237.           SETUP.RP     The main setup file
  238.           FILEBASE.RP  The file database, created by Rpcomp
  239.           MAGIC.RP     The magic files database, created by RPcomp
  240.           TEXTBASE.RP  A database shared by FILEBASE.RP and MAGIC.RP,
  241.                        containing actual directory's and filenames. Don't
  242.                        worry about any duplicate entries!
  243.           LEVEL.RP     Level database
  244.           NODEFILE.RP  Node database
  245.           REQUESTD.RP  This file holds all info about previous requests
  246.  
  247.           ╔════════════════════════════════════════════════════════════════╕
  248.           ║≡ Other files supported ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  249.           ╙────────────────────────────────────────────────────────────────┘
  250.  
  251.           RP supports the following "3rd party" database files.
  252.  
  253.           DESCRIPT.RP  A database containing the file descriptions.
  254.           DESCINFO.RP  A database containing information about the file
  255.                        descriptions.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.           Page 3
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.                                         Prime request processor documentation
  291.  
  292.           ╔════════════════════════════════════════════════════════════════╕
  293.           ║≡ 2 Installation ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  294.           ╙────────────────────────────────────────────────────────────────┘
  295.  
  296.           Unpack the archive in any directory, and execute the install
  297.           utility. It will adjust Setup.FD to install the request processor.
  298.           After using Install.EXE, you need to setup RP itselve, using
  299.           RPsetup.
  300.  
  301.           If you do want to install RP manually in your mailer, here is the
  302.           commandline needed: "rp /x=x /f=f /t=t /r=r /h=h"
  303.  
  304.           After setting up everything properly, you need to run RPcomp to
  305.           create RP's file database.
  306.           It is recommended that you run RPcomp atleast daily in your
  307.           maintenance batchfile, but you are advised to run it after every
  308.           file import, or after you created your announce messages. (modern
  309.           .TIC processors like Allfix have fine ways of telling you that
  310.           files have been imported either using errorlevels or semaphore
  311.           files).
  312.  
  313.           Further, install RPpack and RPcomp in your batchfiles. More about
  314.           these utilities later on.
  315.  
  316.           It is also recommended to install a disk cache, to speed up
  317.           processing.
  318.  
  319.           Following is a detailed explanation about the setup utility.
  320.  
  321.           ╔════════════════════════════════════════════════════════════════╕
  322.           ║≡ Setting up ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  323.           ╙────────────────────────────────────────────────────────────────┘
  324.  
  325.           RP includes a full screen setup utility, for your convenience.
  326.  
  327.           Later on, "recovertime" is mentioned. This is the time in minutes
  328.           how long RP will remember previous requests. It is used for the
  329.           "request limits per timeslot" Recovertime defines the length of
  330.           the timeslot. Ie, if you set it to 60 minutes, previous requests
  331.           are forgotten after 60 minutes. This is only used in the
  332.           registered version.
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.           Page 4
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.                                         Prime request processor documentation
  352.  
  353.           ╔════════════════════════════════════════════════════════════════╕
  354.           ║≡ System parameters ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  355.           ╙────────────────────────────────────────────────────────────────┘
  356.  
  357.           The system parameters menu lets you setup the following things:
  358.  
  359.           External editor     : The editor you want to use for editing your
  360.                                 text files from within the setup utility.
  361.  
  362.           Temporary directory : If filled in, all temporary files are
  363.                                 created there. This includes the PKT file
  364.                                 with the request response message, and any
  365.                                 files in CD-Rom groups. It is important in a
  366.                                 multiline environment to use the $TASK$
  367.                                 macro in the path name, to have unique
  368.                                 directory's for each line. (to prevent your
  369.                                 mailer from deleting files, another task
  370.                                 still has to sent).
  371.  
  372.           Logfile name        : By default, RP logs to your mailers logfile.
  373.                                 If you set this field, RP's own logfile will
  374.                                 be used. You may use also the $TASK$ macro
  375.                                 in this logfile name.
  376.  
  377.           RPcomp logfile name : By default RPcomp will use RP's logfile. If
  378.                                 this field is set, RPcomp's own logfile will
  379.                                 be used. If both the RPcomp logfile name and
  380.                                 RP logfile name are empty, RPcomp will do
  381.                                 *NO* logging. (so it will not use your
  382.                                 mailers logfile). The RPcomp logfile does
  383.                                 *NOT* support the $TASK$ macro, since it is
  384.                                 not supposed to run in multiple tasks.
  385.  
  386.           About text          : Defines the filename which contains the
  387.                                 "about" response message. If you define no
  388.                                 path, RP will look for this in its system
  389.                                 directory.
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.           Page 5
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.                                         Prime request processor documentation
  413.  
  414.           Edit SENDWITH.RP    : Edit the SENDWITH.RP file. SENDWITH.RP is
  415.                                 build up as follows: (ASCII text)
  416.                                 <part of path/filename> <message file>
  417.  
  418.                                 ie, k:\prime\ prime.txt
  419.                                     k:\pdn\ pdn.txt
  420.                                     rp-100 rp.txt
  421.  
  422.                                 Now if part of a filename which is send to
  423.                                 the remote system is for instance k:\pdn\,
  424.                                 pdn.txt is send to the requesting system as
  425.                                 a message, with for instance, a notify of
  426.                                 the fact that you can also connect the file
  427.                                 distribution areas automaticly. The <part-
  428.                                 of> may appear anywhere in the complete path
  429.                                 and filename of the file that is being send.
  430.  
  431.           Edit TPLEXT.RP      : Edit the TPLEXT.RP file. More about this
  432.                                 file in the chapter about templates.
  433.  
  434.           Systempath          : By default RP uses the location of the
  435.                                 executable as system path. If you set this
  436.                                 path however, RP uses this one as a
  437.                                 systempath.
  438.  
  439.           Nodelist lookup     : RP does not get any "listed/unlisted"
  440.                                 information from Frontdoor. If you want to
  441.                                 activate RP's own nodelist lookup routines,
  442.                                 set this to yes. If you turn this off, RP
  443.                                 will be a bit faster (no nodelist lookup),
  444.                                 but every node will be treated as UNLISTED!
  445.  
  446.           Points listed       : Set this to yes, if you want to tread points
  447.                                 of listed systems also as listed.
  448.  
  449.           Nodelist path       : Path to nodelist
  450.  
  451.           Nodelist extension  : Extension of nodelist index. This can be RA
  452.                                 (RP's indexes are compatible with RA), or
  453.                                 something else.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.           Page 6
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.                                         Prime request processor documentation
  474.  
  475.           ╔════════════════════════════════════════════════════════════════╕
  476.           ║≡ Default limits ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  477.           ╙────────────────────────────────────────────────────────────────┘
  478.  
  479.           The default limits menu lets you set up limits for nodes, not
  480.           found in your node database, there are 3 groups:
  481.  
  482.           Unlisted systems, for people not found in de the nodelist
  483.           Unsecure session, for unsecure sessions, and secure session for
  484.           secure sessions. You can setup the groups the requesting system
  485.           may request from, the level (which defines the request limits
  486.           themselves), and the recovertime, which is explained in the
  487.           "setting up" chapter.
  488.  
  489.           ╔════════════════════════════════════════════════════════════════╕
  490.           ║≡ Group manager ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  491.           ╙────────────────────────────────────────────────────────────────┘
  492.  
  493.           In the group manager, you setup the different groups for RP. You
  494.           can give nodes access to groups only at certain times and days, or
  495.           no access at all.
  496.  
  497.           The following fields are available:
  498.  
  499.           Name                : The name of the group. Only used for your
  500.                                 visualization.
  501.  
  502.           Minimum baudrate    : If a requesting node's baudrate is lower
  503.                                 then the one listed here, the group is
  504.                                 disabled.
  505.  
  506.           Limited hours       : If this field is set to yes, time slots are
  507.                                 checked. If a node calls outside a timeslot,
  508.                                 the group is disabled.
  509.  
  510.           Start- and stoptime : These fields define the timeslot. 05:00-
  511.                                 06:00 is allowed (which means that the group
  512.                                 is only available between 5 05:00 and
  513.                                 06:00), and 06:00 and 05:00 is allowed.
  514.                                 (which means that the group is *NOT*
  515.                                 available between 05:00 and 06:00).
  516.  
  517.           Days                : Only on the days listed, requesting is
  518.                                 possible from this group.
  519.  
  520.           Free KBytes         : If set to yes, Kilobytes in this group are
  521.                                 not taken in consideration when checking
  522.                                 request limits.
  523.  
  524.  
  525.  
  526.           Page 7
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.                                         Prime request processor documentation
  535.  
  536.           Free Time           : If set to yes, transfer times in this group
  537.                                 are not taken in consideration when checking
  538.                                 request limits.
  539.  
  540.           Free Match          : If set to yes, the number of files requested
  541.                                 from this group are not taken in
  542.                                 consideration when checking request limits.
  543.  
  544.           Stop match          : RP's search engine will stop searching in
  545.                                 this group, if there was already a "hit" on
  546.                                 the requested file.
  547.  
  548.           CD-Rom              : If set to true, all files in this group will
  549.                                 be copied into the temporary directory
  550.                                 before your mailer will send them.
  551.  
  552.           List                : Full path and filename of plain ascii text
  553.                                 containing a list of directory's, a request
  554.                                 is possible from. You can put a
  555.                                 "!<passwords>" behind a directory name to
  556.                                 indicate a password protected directory.
  557.  
  558.           Magic list          : Full path and filename of a plain ascii text
  559.                                 containing a list of magic files. RP reads
  560.                                 the standard magic filename layout, which
  561.                                 Frontdoor also uses. Any service requests
  562.                                 are ignored.
  563.  
  564.           Password list       : A list of password protected files,
  565.                                 directory's or a unique portions of it. No
  566.                                 wildcards are supported in this file.
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.           Page 8
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                         Prime request processor documentation
  596.  
  597.           ╔════════════════════════════════════════════════════════════════╕
  598.           ║≡ Node manager ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  599.           ╙────────────────────────────────────────────────────────────────┘
  600.  
  601.           In the node manager you set up different request limits for
  602.           different nodes.
  603.           The following fields can be set:
  604.  
  605.           Sysop name          : The name of the sysop. This is only a
  606.                                 reminder for you, and not actually being
  607.                                 used by RP.
  608.  
  609.           Level               : The level defines the actual request limits.
  610.  
  611.           Groups              : The groups the node has request access to,
  612.                                 with respect to time slots.
  613.  
  614.           Recovertime         : Time to "forget" requests in minutes. {+}
  615.  
  616.           Deny requests       : If this field is set to yes, no requests are
  617.                                 accepted from this node. He will receive a
  618.                                 message stating that requests by him are
  619.                                 denied.
  620.  
  621.           ╔════════════════════════════════════════════════════════════════╕
  622.           ║≡ Level Manager ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  623.           ╙────────────────────────────────────────────────────────────────┘
  624.  
  625.           The level defines the actual request limits.
  626.  
  627.           The following fields can be set:
  628.  
  629.           Level               : RP will only use this record if the level of
  630.                                 the user is higher or equal to this level.
  631.                                 The best match will be used.
  632.  
  633.           Baudrate            : RP will only use this record if the baudrate
  634.                                 of the user is higher or equal to this
  635.                                 baudrate. The best match will be used.
  636.  
  637.           Limited hours       : If this field is set to yes, time slots are
  638.                                 checked. A level record can only be used, if
  639.                                 the times in the timeslot are ok, or
  640.                                 disabled.
  641.                                 This will allow you to set different request
  642.                                 limits, depending the time of the day.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.           Page 9
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                         Prime request processor documentation
  657.  
  658.           Start- and stoptime : These fields define the timeslot. 05:00-
  659.                                 06:00 is allowed (which means that the level
  660.                                 record is only available between 5 05:00 and
  661.                                 06:00), and 06:00 and 05:00 is allowed.
  662.                                 (which means that the level is *NOT*
  663.                                 available between 05:00 and 06:00).
  664.  
  665.           Days                : Only on the days listed, this level record
  666.                                 can be used.
  667.  
  668.           Per timeslot {+}
  669.  
  670.           Max. KBytes {+}     : The maximum number of kilobytes that will be
  671.                                 send during a timeslot.
  672.  
  673.           Max. Time {+}       : The maximum transfer time during a timeslot.
  674.  
  675.           Max. Match {+}      : The maximum number of files send during a
  676.                                 timeslot.
  677.  
  678.           Per session
  679.  
  680.           Max. KBytes         : The maximum number of kilobytes that will be
  681.                                 send during a session.
  682.  
  683.           Max. Time           : The maximum transfer time during a session.
  684.  
  685.           Max. Match          : The maximum number of files send during a
  686.                                 session.
  687.  
  688.           ╔════════════════════════════════════════════════════════════════╕
  689.           ║≡ About ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  690.           ╙────────────────────────────────────────────────────────────────┘
  691.  
  692.           One of the many standard "magic names" is ABOUT, which should
  693.           return a message with information about your system. However, with
  694.           Frontdoor, it is quite a lot of work to send an about message, it
  695.           is a lot easier to just send a plain file.
  696.           RP however offers an easy way to send your about text as a
  697.           message, with correct addressing. Just setup an about response
  698.           message in RPsetup, and that file will be send as message to the
  699.           requesting system.
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.           Page 10
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.                                         Prime request processor documentation
  718.  
  719.           ╔════════════════════════════════════════════════════════════════╕
  720.           ║≡ 3 Template files ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  721.           ╙────────────────────────────────────────────────────────────────┘
  722.  
  723.           RP uses a template system for its response messages. The ones not
  724.           used for the actual request response are pretty much your every
  725.           day average template files, but the request response template
  726.           file. Well... I am very much aware of the fact that they look
  727.           mighty strange, but they work.
  728.  
  729.           It is best not to setup a template file from scratch, but to edit
  730.           the existing example templates.
  731.  
  732.           Depending on the result of the request, RP needs to give different
  733.           response messages. Ie, it is quite useless to add a paragraph
  734.           about files that were found, if no files were found. Therefore
  735.           RP's template language has special keywords, which tell RP whether
  736.           or not to include the line. RP's template language also contains
  737.           keywords to change the subject line, or the from name of the
  738.           message {+}.
  739.           Here is a list of them, with an explanation when they are
  740.           included:
  741.  
  742.           @SUBJECT@           The line after this keywords will be the
  743.                               subject of the message. This defaults to
  744.                               "Request response message".
  745.           @WHOFROM@           Changes the Who From name {+}. This defaults
  746.                               to "Request Processor".
  747.           @LIMITKB@           Sets the "kilobyte limit" text, used in the
  748.                               %REASON% keyword. This defaults to "kilobyte
  749.                               limit".
  750.           @LIMITTM@           Sets the "time limit" text, used in the
  751.                               %REASON% keyword. This defaults to "time
  752.                               limit".
  753.           @LIMITMT@           Sets the "match limit" text, used in the
  754.                               %REASON% keyword. This defaults to "match
  755.                               limit".
  756.           @LIMITNE@           Sets the "next event in the way" text, used in
  757.                               the %REASON% keyword. This defaults to "next
  758.                               event in the way".
  759.           @NODESCR@           Sets the "no description available" text, used
  760.                               in the %DESCRIPTIONS% keyword. This defaults
  761.                               to "no description available".
  762.           @SETMARG@           Sets the margin for descriptions. This
  763.                               defaults to 55. Words will be wrapped
  764.                               automaticly.
  765.           @COMMENT@           This line will never be included. Just meant
  766.                               as comment to you.
  767.  
  768.  
  769.  
  770.           Page 11
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.                                         Prime request processor documentation
  779.  
  780.           @SENDFLS@           Only if files are actually sent, this line
  781.                               will be included. The %FILES% keyword can be
  782.                               used in this line, and will be replaced by the
  783.                               filename being sent. (a line with the %FILES%
  784.                               keywords is repeated for every file that is
  785.                               being sent).
  786.                               The %DESCRIPTION% keyword can also be used in
  787.                               a line with a %FILES% keyword, %DESCRIPTION%
  788.                               which will be replaced with the description of
  789.                               the file.
  790.           @NSNDFLS@           If no files were send, this line will be
  791.                               included.
  792.           @LIMITED@           Only if files are not sent because of request
  793.                               limits, this line will be included. The
  794.                               %FILES% and %REASON% keywords can be used in
  795.                               this line, and will be replaced by
  796.                               respectively the filename and the reason why
  797.                               it could not be sent. (a line with the %FILES%
  798.                               keywords is repeated for every file that could
  799.                               not be send).
  800.           @NOMATCH@           Only if requests were made with no matching
  801.                               file or magic name, this line will be added.
  802.                               The %REQUESTS% macro can be used in this line,
  803.                               and will be replaced by the filespecification
  804.                               the user requested. (a line with the
  805.                               %REQUESTS% macro will be repeated for every
  806.                               filespecification that is not found).
  807.           @DGROUPS@           Only if groups are disabled, and certain
  808.                               requests did not have a matching file or magic
  809.                               name, this line will be included. The
  810.                               %DGROUPS% and %DGROUPSNAME% can be used in
  811.                               this line (one or both), and are replaced by
  812.                               respectively the group tag, and the group
  813.                               name. (a line with either the %DGROUPS% and/or
  814.                               the %DGROUPSNAME% keyword will be repeated for
  815.                               every disabled group).
  816.           @NOLIMIT@           Only if the remote site has no request limits
  817.                               at all, this line is included.
  818.           @YSLIMIT@           If the remote site has one or more request
  819.                               limits, this line is included.
  820.           @KSLIMIT@           If the remote site has a kilobyte request
  821.                               limit per session, this line is included.
  822.           @KTLIMIT@           If the remote site has a kilobyte request
  823.                               limit per timeslot, this line is included.
  824.           @TSLIMIT@           If the remote site has a time request limit
  825.                               per session, this line is included.
  826.           @TTLIMIT@           If the remote site has a time request limit
  827.                               per timeslot, this line is included.
  828.  
  829.  
  830.  
  831.           Page 12
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                                         Prime request processor documentation
  840.  
  841.           @MSLIMIT@           If the remote site has a match request limit
  842.                               per session, this line is included.
  843.           @MTLIMIT@           If the remote site has a match request limit
  844.                               per timeslot, this line is included.
  845.           @YNLIMIT@           This line is included if the remote site has
  846.                               request limits set, but not all.
  847.           @YTLIMIT@           This line is included if the remote site has
  848.                               timeslot limits set. The %TIMESLOT% macro can
  849.                               be used here, which expands to the time in
  850.                               minutes a timeslot lasts.
  851.           @FAILEDR@           This line is included if the request somehow
  852.                               failed. (ie, files not found, or request
  853.                               limits).
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.           Page 13
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.                                         Prime request processor documentation
  901.  
  902.           ╔════════════════════════════════════════════════════════════════╕
  903.           ║≡ Keywords ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  904.           ╙────────────────────────────────────────────────────────────────┘
  905.  
  906.           RP also supports the "standard" set of keywords. Here is a list of
  907.           them:
  908.  
  909.           %MYAKA%             Replaced with the AKA used to send a message
  910.                               (RP uses your mailers aka matching table to
  911.                               decided which aka to use)
  912.           %YOURAKA%           The main AKA used by the Remote System.
  913.           %FULLNAME%          The name of the sysop of the remote system.
  914.           %FIRSTNAME%         The first name of the sysop of the Remote
  915.                               system.
  916.           %LASTNAME%          The last name of the sysop of the remote
  917.                               system.
  918.           %DATE%              Current date.
  919.           %TIME%              Current time.
  920.           %PROGRAM%           Program name and version. In unregistered
  921.                               mode, this keyword is mandatory. If not used,
  922.                               RP will attach a line at the bottem of the
  923.                               message.
  924.           %KBREQTOTAL%        Total kilobytes requested (in this and other
  925.                               sessions during the current timeslot).
  926.           %NRREQTOTAL%        Total files requested (in this and other
  927.                               sessions during the current timeslot).
  928.           %KBREQSES%          Total kilobytes requested in this session.
  929.           %NRREQSES%          Total number of files requested in this
  930.                               session.
  931.           %KBREQTSL%          Total kilobytes requested in previous
  932.                               sessions. (during the current timeslot).
  933.           %NRREQTSL%          Total number of files requested in previous
  934.                               sessions. (during the current timeslot)
  935.           %KSLIMIT%           The kilobytes per session limit.
  936.           %KTLIMIT%           The kilobytes per timeslot limit.
  937.           %TSLIMIT%           The time per session limit.
  938.           %TTLIMIT%           The time per timeslot limit.
  939.           %MSLIMIT%           The match per session limit.
  940.           %MTLIMIT%           The match per timeslot limit.
  941.  
  942.           Further, if the last character of a line is a backslash (\), no
  943.           carriage return will be placed in the message after this line.
  944.           (ie, use this in paragraphs)
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.           Page 14
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.                                         Prime request processor documentation
  962.  
  963.           ╔════════════════════════════════════════════════════════════════╕
  964.           ║≡ Template filenames ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  965.           ╙────────────────────────────────────────────────────────────────┘
  966.  
  967.           Templates can be placed anywhere on your HD, but if you do not
  968.           specify a path, RP will look for them in the system directory.
  969.           A few template names are hardcoded, reqresp.tpl (the request
  970.           response message), and noreq.tpl, send if a node may not request.
  971.  
  972.           ╔════════════════════════════════════════════════════════════════╕
  973.           ║≡ Language specific templates ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  974.           ╙────────────────────────────────────────────────────────────────┘
  975.  
  976.           RP can send a template, depending on (part of) the nodenumber of
  977.           the system requesting. It uses the file TPLEXT.RP for that, with
  978.           the following format:
  979.  
  980.           <part-of-nodenumber> <extension>
  981.           <part-of-nodenumber> <extension>
  982.  
  983.           For instance:
  984.  
  985.           2:512/149 MYP
  986.           2:512/ DUT
  987.           2:500/ DUT
  988.           2:28   DUT
  989.           2:24   GER
  990.  
  991.           If a line matches, RP will first look for a template with the
  992.           original filename, but with the new extension. If not found, RP
  993.           will try to open the original filename.
  994.           The first match goes, so 2:512/149 goes before 2:512/.
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.           Page 15
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.                                         Prime request processor documentation
  1023.  
  1024.           ╔════════════════════════════════════════════════════════════════╕
  1025.           ║≡ 4 Compilers ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1026.           ╙────────────────────────────────────────────────────────────────┘
  1027.  
  1028.           RP includes several compilers, to compile your file database,
  1029.           nodelists and several external description compilers.
  1030.  
  1031.           ╔════════════════════════════════════════════════════════════════╕
  1032.           ║≡ RPcomp ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1033.           ╙────────────────────────────────────────────────────────────────┘
  1034.  
  1035.           RPcomp is the file database compiler of RP. The reasons for RP
  1036.           using a file database are quite simple. It is faster, and easier
  1037.           to search in. (with speed being the most important reason).
  1038.           The database RPcomp creates is described in the RPSTRUCT.INC
  1039.           document.
  1040.  
  1041.           The reason for speed being so important is obvious, the searching
  1042.           of files is done during the session, which could be an expensive
  1043.           long distance call.
  1044.  
  1045.           RPcomp requires no parameters. After firing up, RP instantly
  1046.           compiles your file database.
  1047.           RPcomp can be run while your mailer is online, and even when RP is
  1048.           processing a request. RP handles this. Please note that only one
  1049.           copy of RPcomp may run at a time.
  1050.  
  1051.           RPcomp lays no static link to the description database. Ie, the
  1052.           order of compiling is not important.
  1053.  
  1054.           ╔════════════════════════════════════════════════════════════════╕
  1055.           ║≡ RPnl ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1056.           ╙────────────────────────────────────────────────────────────────┘
  1057.  
  1058.           RPnl is RP's nodelist compiler. Use it as follows:
  1059.  
  1060.           RPNL <nodelist1> <nodelist2> <nodelist3>
  1061.  
  1062.           If you do not provide an extension, RPnl will look for the latest
  1063.           nodelist itselve. (RPnl does not support wildcards, so don't put
  1064.           NODELIST.* on the commandline).
  1065.           RPnl can handle up to 20 nodelists, but in a Frontdoor system
  1066.           "RPNL nodelist fdnet.pvt" is sufficient.
  1067.  
  1068.           Note, RPnl isn't exactly what you would call very fast. I would
  1069.           recommend using OTNL (included with the great netmail tracker O/T-
  1070.           Track), which is more then twice as fast then RPnl.
  1071.  
  1072.           If you run Remote Access, or O/T-Track, RP can read the indexes
  1073.           from those programs. Insert the right extension in RPsetup.
  1074.  
  1075.           Page 16
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.                                         Prime request processor documentation
  1084.  
  1085.           ╔════════════════════════════════════════════════════════════════╕
  1086.           ║≡ FBBSDESC ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1087.           ╙────────────────────────────────────────────────────────────────┘
  1088.  
  1089.           FBBSdesc is a description compiler for RP. It takes the file
  1090.           descriptions out of Files.BBS. It supports multiline descriptions,
  1091.           and wildcards in Files.BBS.
  1092.  
  1093.           Fire it up with either RP, or a filename containing directory's to
  1094.           include, ie:
  1095.  
  1096.           FBBSDESC RP or
  1097.           FBBSDESC dirlist.txt
  1098.  
  1099.           You can optionally use the /a commandline switch, to append to the
  1100.           database, instead of creating a new one. (for instance if you
  1101.           already have compiled a description database specific to your BBS
  1102.           package, and want to add a few directory's with just a files.bbs
  1103.           in it).
  1104.  
  1105.           ╔════════════════════════════════════════════════════════════════╕
  1106.           ║≡ RAdesc ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1107.           ╙────────────────────────────────────────────────────────────────┘
  1108.  
  1109.           This program converts the file descriptions in the Remote Access
  1110.           File Database to RP format. It only takes the /a commandline
  1111.           switch, to append to the RP's description database, instead of
  1112.           creating a new one.
  1113.  
  1114.           ╔════════════════════════════════════════════════════════════════╕
  1115.           ║≡ MAXdesc ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1116.           ╙────────────────────────────────────────────────────────────────┘
  1117.  
  1118.           This program compiles the file descriptions from Maximus.
  1119.           (standard Files.BBS with parameters). On the commandline, enter
  1120.           full path and name of your FileArea.CTL. You can also use the /a
  1121.           commandline switch, to append to the RP's description database,
  1122.           instead of creating a new one.
  1123.  
  1124.           ╔════════════════════════════════════════════════════════════════╕
  1125.           ║≡ Other compilers ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1126.           ╙────────────────────────────────────────────────────────────────┘
  1127.  
  1128.           Other description compilers are in the making. If your BBS
  1129.           supports Files.BBS, FBBSDESC can be used, if your BBS package uses
  1130.           a specific database format, you can request a compiler for it.
  1131.  
  1132.           Please send as much information as possible about the database
  1133.           format being used. If you are a programmer, you can also program
  1134.           one yourselves, and earn a free RP key (look at freereg.!!!).
  1135.  
  1136.           Page 17
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.                                         Prime request processor documentation
  1145.  
  1146.           ╔════════════════════════════════════════════════════════════════╕
  1147.           ║≡ 5 RPpack ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1148.           ╙────────────────────────────────────────────────────────────────┘
  1149.  
  1150.           RPpack packs the requested files database from RP. This file
  1151.           (requestd.rp) contains information for RP to handle request limits
  1152.           per timeslot, and remembering requests.
  1153.           RPpack only keeps the last 500 records of this file. It needs no
  1154.           additional parameters.
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.           Page 18
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.                                         Prime request processor documentation
  1206.  
  1207.           ╔════════════════════════════════════════════════════════════════╕
  1208.           ║≡ 6 RP at work ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1209.           ╙────────────────────────────────────────────────────────────────┘
  1210.  
  1211.           When your mailer encounters a file request message, it will create
  1212.           a file with all requested files. RP will read this file, and
  1213.           search the database for all matching filenames. (filtering out any
  1214.           duplicate names).
  1215.           After all checking, a list of files to send to the user is
  1216.           created, descriptions are gathered, response messages are created
  1217.           and control is given back to your mailer, which on his turn sends
  1218.           the files, and the response message(s) to the requesting system.
  1219.  
  1220.           RP can not really check if a request came through all the way. Ie,
  1221.           the connection could be lost during a file transfer. Therefore, RP
  1222.           will store each file send, per system. Now if a system requests
  1223.           the same file again, it is probably because of a request failure,
  1224.           the files are not counted again!
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.           Page 19
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.                                         Prime request processor documentation
  1267.  
  1268.           ╔════════════════════════════════════════════════════════════════╕
  1269.           ║≡ 7 Support ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1270.           ╙────────────────────────────────────────────────────────────────┘
  1271.  
  1272.           For a list of international support and registration sites, please
  1273.           look in Support.DOC.
  1274.  
  1275.           If you have any problem when running or installing RP, we
  1276.           appreciate a call or message from you. Don't just delete it!
  1277.  
  1278.           ╔════════════════════════════════════════════════════════════════╕
  1279.           ║≡ Thanks ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1280.           ╙────────────────────────────────────────────────────────────────┘
  1281.  
  1282.           Many persons contributed in the development of RP, here are some
  1283.           of them in no particular order.
  1284.  
  1285.           Thanks to Peter Hampf, Frank Troost (for receiving many response
  1286.           messages ;-)), Wilfried Rutjes, Gerrit Mak, Eckhardt von dem
  1287.           Berge, Hans de Vor, Jan R. Koopmans, Cor Gloudie and many more
  1288.           suggesting nice features during the development stage.
  1289.           Of course a special thanks to Marco Miltenburg for producing the
  1290.           setup utility, and also a special thanks to Peter Hampf for
  1291.           various things.
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.           Page 20
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.                                         Prime request processor documentation
  1328.  
  1329.           ╔════════════════════════════════════════════════════════════════╕
  1330.           ║≡ 8 Shareware ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1331.           ╙────────────────────────────────────────────────────────────────┘
  1332.  
  1333.           RP is distributed under the shareware concept. You may evaluate RP
  1334.           for a period of one (1) month, after which you must either stop
  1335.           using the software, or register it. The unregistered version will
  1336.           not bleep, delay or other annoying stuff. It only lacks the
  1337.           "request limits per timeslot".
  1338.  
  1339.           Current price is Hfl 30,- or US$ 25,-. For prices in other
  1340.           currency's, fire up the REGFORM program, which tells you the price
  1341.           in the currency of the registration sites. There is no separate
  1342.           price for commercial usage.
  1343.  
  1344.           Group discount is available on request, and starts with 5 copies
  1345.           or more.
  1346.  
  1347.           ╔════════════════════════════════════════════════════════════════╕
  1348.           ║≡ Legal stuff / standard disclaimer ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1349.           ╙────────────────────────────────────────────────────────────────┘
  1350.  
  1351.            ■ In no event shall Prime Productions nor Hans Siemons nor any of
  1352.              his support sites be liable to you or anyone else for any
  1353.              damage directly or indirectly caused by RP or it's accompanying
  1354.              products. Prime Productions, Hans Siemons and Marco Miltenburg
  1355.              guarantee that no code is made to deliberately damage yours or
  1356.              anyone else his system, and that there are no intentional flaws
  1357.              in the security system.
  1358.            ■ All executables, documents and example files are copyrighted
  1359.              (c) 1993,94 by Hans Siemons, Marco Miltenburg and Prime
  1360.              Productions. You may however share UNMODIFIED copies of this
  1361.              product, as long as no money is charged or accepted, other then
  1362.              cost of the material.
  1363.            ■ RP is distributed under the shareware concept. This means that
  1364.              after one (1) month, you must either register, or stop using
  1365.              the software. RAPWDLST is excluded from this. RAPWDLST is
  1366.              public domain, with no rights reserved.
  1367.            ■ All brands and product names named in this documentation are
  1368.              trademarks or registered trademarks of there respective
  1369.              holders.
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.           Page 21
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.                                         Prime request processor documentation
  1389.  
  1390.           ╔════════════════════════════════════════════════════════════════╕
  1391.           ║≡ 9 Future versions ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1392.           ╙────────────────────────────────────────────────────────────────┘
  1393.  
  1394.           There are some things I would like to do for a next version.
  1395.           Things on the current to-do list are:
  1396.  
  1397.            ■ Wildcard support in the node manager.
  1398.            ■ Support for InterMail
  1399.            ■ Add a Replace.RP. Ie, a node requests RP100.ARJ, and that
  1400.              request will automaticly replaced with RP101.ARJ, and a few
  1401.              lines in the request response message that his request was
  1402.              replaced.
  1403.  
  1404.           And of course, useful suggestions are more then welcome.
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.           Page 22
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                         Prime request processor documentation
  1450.  
  1451.           ╔════════════════════════════════════════════════════════════════╕
  1452.           ║≡ 10 Technical notes ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1453.           ╙────────────────────────────────────────────────────────────────┘
  1454.  
  1455.           RP supports Frontdoor 2.20(a) and 2.11 fully. It does *NOT*, I
  1456.           repeat *NOT* take any request limits from Setup.FD. All request
  1457.           limits should be defined in RPsetup, if they are not defined in
  1458.           RPsetup, there are no request limits!
  1459.           When groups are disabled (because they are simply unavailable, or
  1460.           made unavailable because of time slots) or passwords don't match,
  1461.           the file is simply not found. The search logic prevent RP from
  1462.           even coming close to finding it ;-)
  1463.  
  1464.           Errors in magic filenames and stuff are not seen as errors. RPcomp
  1465.           just reads the stuff, and stores valid information.
  1466.  
  1467.           RP will never send the same file more then once in a session. RP's
  1468.           search engine first makes a full list of all matching files. This
  1469.           list later on goes trough a "limit checker", producing a list of
  1470.           files to send.
  1471.  
  1472.           Also mind the following, if a file could be found in group A, and
  1473.           in group B (and the node had access to both), and the file in
  1474.           Group A is only free KB, and the file in Group B only free time,
  1475.           the file will be both free KB, and free time!
  1476.  
  1477.           RP creates fts-0001 and fsc-0039 compatible packets. It uses ftsc
  1478.           productcode 0xffh, since there no codes available anymore. You can
  1479.           identify a packet created by RP by the productcode 0xffh, and the
  1480.           longdata field contains 0x00525052h <RPR#0>.
  1481.  
  1482.           RP was programmed using Borland Pascal with Objects 7.0, including
  1483.           the tools that came with it (Turbo Profiler, debugger and
  1484.           assembler).
  1485.           Source files were edited using Semware's QEdit.
  1486.  
  1487.           RPsetup was developed by Marco Miltenburg. Thanks a lot!
  1488.           The original visual interface concept of RPsetup is designed by
  1489.           Joaquim Homrighausen. Used with permission.
  1490.  
  1491.           Structures used by RP are included as RPSTRUCT.INC.
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.           Page 23
  1503.